home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 1 / Gigarom Macintosh Archives (Quantum Leap)(CDRM1080320)(1993).iso / FILES / APP / A-D / BBEdit 2.2.2.sea / BBEdit 2.2.2 / About TextChanger < prev    next >
Text File  |  1993-04-06  |  8KB  |  184 lines
  1. ABOUT TextChanger
  2. ----- -----------
  3.  
  4. (By the way, this document was created with BBEdit. If you aren’t
  5. using BBEdit now, give it a try - it’s free, and available from
  6. most popular on-line services and BBSes.)
  7.  
  8. TextChanger is an application which will scan your disk drives for
  9. text files, and allow you to selectively change their creators or 
  10. delete the contents of their resource forks. This idea is not new;
  11. for years, there has been an application called “TEXT Ranger”,
  12. written by Darin Adler of Apple Computer, which does the same thing.
  13. However, TextChanger adds some unique capabilities:
  14.  
  15.     -    TextChanger will identify the application which created the
  16.         document, if that application is present on any mounted disk.
  17.         
  18.     -    Whenever a new type of text file is encountered, you can 
  19.         instruct TextChanger to show you the file; TextChanger will
  20.         then open the window in the Finder which contains the file,
  21.         and select the file. (This is so that you can establish the
  22.         context in which the file exists, or even open it up to view
  23.         its contents. Having this context often helps in deciding 
  24.         what to do with the file.)
  25.         
  26.     -    TextChanger can operate in the background.
  27.  
  28. An example use of TextChanger:
  29.  
  30.     a programmer who we’ll call “Robert M.” (to protect his identity)
  31.     has decided to ditch the MPW Shell in favor of BBEdit. He there-
  32.     fore would like to convert all his MPW-created files to have
  33.     BBEdit’s signature, so that when he double-clicks them, the Finder
  34.     will open BBEdit, instead of giving him some alert about not 
  35.     being able to find the application that created his documents.
  36.     
  37. To scan a disk, simply double-click on TextChanger. When TextChanger
  38. comes up, click to dismiss the splash screen. A dialog will be presented
  39. so that you can select a disk to scan. Click the “Drive” button until
  40. the name of your desired disk is shown in the dialog, and then click
  41. the “Scan” button. (Under System 7, it will be the “Open” button.
  42. The Standard File package is a little too smart for its own good.)
  43.  
  44. You can also scan a disk or a folder by dropping its icon onto
  45. TextChanger, if you’re running System 7.
  46.  
  47. TextChanger will then start scanning the drive (or folder). As it does so, it
  48. will display the name of the folder being scanned, and the name of the file
  49. currently being examined. (This last will change rather quickly.) To cancel a
  50. scan in progress, click the “Cancel” button in the progress dialog.
  51.  
  52. Whenever TextChanger encounters a file of a type it hasn’t seen, it
  53. will put up another dialog asking you what to do. There are a number
  54. of actions you can take:
  55.  
  56.     -    Enter a application signature code in the text field, and turn
  57.         on the “Change Creator to” checkbox. If you don’t know the
  58.         signature code for your desired application, you can click
  59.         the “Choose” button; if you then select an application program
  60.         and click “Open”, that application’s signature will be entered
  61.         in the text field for you.
  62.         
  63.     -    Turn on the “Zap Resource Fork” option to delete any resource
  64.         information that may exist in the file. (Text editors often
  65.         store information in the resource fork such as the font and
  66.         size used to display this file’s contents, the last window
  67.         position and size of the file, and so on. MPW also stores
  68.         information related to its Projector source-control system
  69.         in the resource fork of the file.)
  70.         
  71.     -    Don’t turn on any options, and click “OK”. When you do this,
  72.         files of the same type as the indicated file will not be 
  73.         affected at all.
  74.         
  75.     -    Click the “Show” button. The indicated file will be displayed
  76.         in the Finder. With this information, you can determine what,
  77.         if anything, you should do. To resume the scan, bring TextChanger
  78.         to the front again.
  79.         
  80.     -    Click the “Cancel” button to cancel the scan.
  81.     
  82. After selection the appropriate options, click “OK” to continue the scan.
  83. When TextChanger is finished, the disk-selection dialog will reappear.
  84. You can then choose another disk, or click “Quit” to quit TextChanger.
  85.  
  86. CREDITS
  87. -------
  88.  
  89. The idea of an application to “search and destroy” rogue creators and
  90. resource forks isn’t new; the “TEXT Ranger” program by Darin Adler
  91. goes back to 1989 (and probably before).
  92.  
  93. Robert Munafo provided the impetus for TextChanger by musing about
  94. how nice it would be to actually be able to examine the document
  95. before deciding what to do with it.
  96.  
  97. TextChanger uses file-search libraries which are part of the Programmer’s
  98. Editor Package. For more information, write the the address at the end of 
  99. this text file.
  100.  
  101. UPDATE NOTES
  102. ------ -----
  103.  
  104. Version 1.0.1    (1/10/93)
  105.  
  106. This maintenance release to TextChanger fixes a crash which would occur
  107. when repeatedly clicking on the “Drive” button. Also, the desired actions
  108. for each file type persist for the duration of that invocation of
  109. TextChanger, so if you can multiple volumes, you won’t have to
  110. re-enter your desired actions for each volume.
  111.  
  112. A Note About Shareware vs. Freeware
  113. - ---- ----- --------- --- --------
  114.  
  115.     I have released a number of shareware programs over time, and I have found
  116. that the cash return is so small as to be useless. From a user’s point of view,
  117. I object to being “guilt-tripped” into sending some tiny amount of money for a
  118. program, and I can see no justifiable reason to  expect others to do what I’m
  119. no longer willing to do. For these and other reasons, I am releasing TextChanger as
  120. “freeware”: I ask for no money for the right for others to use it and give it
  121. away. My reward will come, hopefully, in seeing TextChanger being used by people
  122. who value its utility.
  123.  
  124. Some Minor Legal Stuff
  125.  
  126.     Although TextChanger is free, it is not “public domain”. It is copyrighted,
  127.     and the copyright will be enforced whenever appropriate.
  128.     
  129.     •    The source is not available.
  130.     
  131.     •    TextChanger cannot be sold, either by itself or in combination with
  132.         any other product, without my express written permission. The one
  133.         exception to this rule is made for user groups. If you’re a user group
  134.         which is publishing a CD-ROM or floppy collection, you may include
  135.         TextChanger and all of its included files without restriction, save that
  136.         the original package is included. Contact me for up-to-date
  137.         versions and information.
  138.         
  139.     •    TextChanger may be posted on an information service which charges
  140.         its users for general connection time and downloading, but it may
  141.         NOT be posted to an information service which will charge for the
  142.         specific right to download TextChanger, without my express written
  143.         permission.
  144.  
  145.     •    TextChanger may be given away as a support utility for a package
  146.         which is itself to be given away. People who have need to 
  147.         distribute TextChanger as a support utility should contact me
  148.         for up-to-date versions and information.
  149.         
  150.     •    The following warranty is merely to cover the bases:
  151.     
  152.         Rich Siegel makes no warranty, express or implied, with respect
  153.         to the software or documentation including (but not limited to)
  154.         implied warranties of merchantability and fitness for a 
  155.         particular purpose. In no event will Rich Siegel be liable for
  156.         loss of profits or goodwill or other indirect, special,
  157.         incidental, or consequential damages resulting from any
  158.         defect in the software or documentation, even if advised of the
  159.         possibility of such damages. Rich Siegel shall have no liability
  160.         for any data stored or modified with this program, including the
  161.         costs of recovering such data.
  162.         
  163.         Some states do not allow the exclusion or limitation of implied
  164.         warranties or liability for incidental or consequential
  165.         damages, so the above limitation or exclusion may not apply 
  166.         to you. This warranty gives you specific legal rights, and you may
  167.         also have other rights which vary from state to state.
  168.         
  169. TextChanger is copyright ©1992 by Richard M. Siegel. All rights reserved.
  170.  
  171. Questions? Problems? Praise? Suggestions? Want to be a beta site?
  172. Address correspondence to:
  173.  
  174. Rich Siegel
  175. 6 Village Way #23
  176. Natick, MA 01760
  177.  
  178. Internet/Usenet: bbedit@world.std.com
  179.  
  180. If you need an up-to-date version, send written correspondence with
  181. a stamped, self-addressed floppy mailer, and either a floppy or $2.00
  182. to the above address.
  183.  
  184.